CircleCI MCP 서버
CircleCI MCP 서버
개요
CircleCI MCP 서버는 CircleCI와 Model Context Protocol (MCP) 간의 통합을 제공하는 공식 서버입니다. CircleCI는 소프트웨어 팀을 위한 지속적 통합 및 배포(CI/CD) 플랫폼으로, 이 MCP 서버는 AI 어시스턴트가 CircleCI의 개발 워크플로우에 접근할 수 있게 해줍니다. 이를 통해 빌드 실패 로그 확인, 불안정 테스트 찾기, 파이프라인 상태 확인 등의 작업을 자연어로 쉽게 수행할 수 있습니다.
특징
- 빌드 실패 로그 검색: CircleCI 빌드 실패 로그를 상세하게 확인
- 불안정한 테스트 식별: CircleCI 프로젝트에서 불안정한 테스트를 분석
- 파이프라인 상태 확인: 특정 브랜치에 대한 최신 파이프라인 상태 조회
- 테스트 결과 분석: CircleCI 작업의 테스트 메타데이터 확인
- 설정 도우미: CircleCI 설정 작업에 대한 지침 및 검증 제공
- 파이프라인 실행: 특정 브랜치에 대한 파이프라인 실행
API
리소스
- 빌드(Builds)
- 파이프라인(Pipelines)
- 워크플로우(Workflows)
- 작업(Jobs)
- 테스트 결과(Test Results)
- 설정(Configuration)
도구
빌드 실패 로그 검색
- get_build_failure_logs: CircleCI 빌드에서 상세한 실패 로그를 검색합니다
- 입력: CircleCI URL 또는 로컬 프로젝트 컨텍스트(작업 공간 루트 경로, Git 원격 URL, 브랜치 이름)
- 출력: 작업 이름, 단계별 실행 세부 정보, 실패 메시지 및 컨텍스트가 포함된 형식화된 로그
불안정한 테스트 식별
- find_flaky_tests: CircleCI 프로젝트에서 테스트 실행 기록을 분석하여 불안정한 테스트를 식별합니다
- 입력: CircleCI 프로젝트 URL 또는 로컬 프로젝트 컨텍스트(작업 공간 루트 경로, Git 원격 URL)
- 출력: 테스트 이름, 파일 위치, 실패 메시지 등을 포함한 불안정한 테스트에 대한 세부 정보
파이프라인 상태 확인
- get_latest_pipeline_status: 지정된 브랜치의 최신 파이프라인 상태를 검색합니다
- 입력: CircleCI 프로젝트 URL 또는 로컬 프로젝트 컨텍스트(작업 공간 루트 경로, Git 원격 URL, 브랜치 이름)
- 출력: 워크플로우 이름 및 현재 상태, 각 워크플로우 기간, 생성 및 완료 타임스탬프, 전체 파이프라인 상태 등이 포함된 형식화된 상태
작업 테스트 결과 확인
- get_job_test_results: IDE를 벗어나지 않고 테스트 결과를 분석할 수 있도록 CircleCI 작업에 대한 테스트 메타데이터를 검색합니다
- 입력: CircleCI URL 또는 로컬 프로젝트 컨텍스트(작업 공간 루트 경로, Git 원격 URL, 브랜치 이름)
- 출력: 모든 테스트 요약(총 개수, 성공, 실패), 실패한 테스트에 대한 세부 정보(테스트 이름, 클래스, 파일 위치, 오류 메시지, 실행 시간), 타이밍 정보가 포함된 성공한 테스트 목록
설정 도우미
- config_helper: CircleCI 설정 작업에 대한 지침과 검증을 제공합니다
- 입력: 검증 요청 및 설정 파일 경로
- 출력: 상세한 검증 결과 및 설정 권장 사항
프롬프트 템플릿 생성
- create_prompt_template: 기능 요구 사항을 기반으로 AI 지원 애플리케이션을 위한 구조화된 프롬프트 템플릿을 생성합니다
- 입력: 기능 요구 사항 설명
- 출력: 구조화된 프롬프트 템플릿 및 필요한 입력 매개변수를 정의하는 컨텍스트 스키마
프롬프트 템플릿 테스트 추천
- recommend_prompt_template_tests: 프롬프트 템플릿이 예상 결과를 생성하는지 확인하기 위한 테스트 케이스를 생성합니다
- 입력: 프롬프트 템플릿 및 컨텍스트 스키마
- 출력: 권장 테스트 케이스 배열 및 템플릿 견고성을 테스트하기 위한 다양한 매개변수 조합
파이프라인 실행
- run_pipeline: 파이프라인 실행을 트리거합니다
- 입력: CircleCI URL 또는 로컬 프로젝트 컨텍스트(작업 공간 루트 경로, Git 원격 URL, 브랜치 이름)
- 출력: 파이프라인 실행을 모니터링하기 위한 링크
사용 방법
사전 요구사항
- pnpm 패키지 관리자
- Node.js v18.0.0 이상
- CircleCI API 토큰
설치 및 구성
API 토큰 얻기
Cursor에 설치
Cursor MCP 설정에 다음을 추가하세요:
{
"mcpServers": {
"circleci-mcp-server": {
"command": "npx",
"args": ["-y", "@circleci/mcp-server-circleci"],
"env": {
"CIRCLECI_TOKEN": "your-circleci-token",
"CIRCLECI_BASE_URL": "https://circleci.com" // 선택적 - 온프레미스 고객만 필요
}
}
}
}VS Code에 설치
.vscode/mcp.json에 다음을 추가하세요:
{
"inputs": [
{
"type": "promptString",
"id": "circleci-token",
"description": "CircleCI API Token",
"password": true
}
],
"servers": {
"circleci-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@circleci/mcp-server-circleci"],
"env": {
"CIRCLECI_TOKEN": "${input:circleci-token}"
}
}
}
}Claude Desktop에 설치
claude_desktop_config.json에 다음을 추가하세요:
{
"mcpServers": {
"circleci-mcp-server": {
"command": "npx",
"args": ["-y", "@circleci/mcp-server-circleci"],
"env": {
"CIRCLECI_TOKEN": "your-circleci-token",
"CIRCLECI_BASE_URL": "https://circleci.com" // 선택적 - 온프레미스 고객만 필요
}
}
}
}이 파일은 다음 위치에서 찾을/생성할 수 있습니다:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Claude Code에 설치
Claude Code를 설치한 후 다음 명령을 실행하세요:
claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleciWindsurf에 설치
Windsurf mcp_config.json에 다음을 추가하세요:
{
"mcpServers": {
"circleci-mcp-server": {
"command": "npx",
"args": ["-y", "@circleci/mcp-server-circleci"],
"env": {
"CIRCLECI_TOKEN": "your-circleci-token",
"CIRCLECI_BASE_URL": "https://circleci.com" // 선택적 - 온프레미스 고객만 필요
}
}
}
}Smithery를 통한 설치
Claude Desktop에 CircleCI MCP 서버를 자동으로 설치하려면 Smithery를 사용하세요:
npx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude사용 예시
- "내 브랜치의 최신 실패한 파이프라인을 찾고 로그를 가져와줘"
- "이 프로젝트에서 불안정한 테스트를 찾아줘"
- "내 현재 프로젝트의 main 브랜치에 있는 최신 파이프라인 상태를 알려줘"
- "이 CircleCI 작업의 테스트 결과를 분석해줘"
- "내 CircleCI 설정을 검증해줘"
- "main 브랜치에서 파이프라인을 실행해줘"